package com.vegetable.modules.mapper.finance;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.vegetable.modules.entity.finance.vo.CustomerCollectionAlertRecordVO;
import com.vegetable.modules.entity.finance.vo.CustomerOverdueStatisticsVO;
import com.vegetable.modules.entity.finance.vo.OverdueLevelStatisticsVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * <p>
 * 客户回款预警 - 实时查询 Mapper 接口
 * </p>
 *
 * @author vegetable
 * @since 2025-10-24
 */
@Mapper
public interface CustomerCollectionAlertRecordMapper {

    /**
     * 实时查询超期未回款订单列表
     *
     * @param params 查询参数
     * @return 订单列表
     */
    List<CustomerCollectionAlertRecordVO> selectOverdueOrdersList(@Param("params") Map<String, Object> params);

    /**
     * 统计超期未回款订单总数
     *
     * @param params 查询参数
     * @return 总数
     */
    Long countOverdueOrders(@Param("params") Map<String, Object> params);

    /**
     * 按逾期等级统计未回款账期生命周期
     *
     * @param params 查询参数
     * @return 统计列表
     */
    List<OverdueLevelStatisticsVO> selectOverdueLevelStatistics(@Param("params") Map<String, Object> params);

    /**
     * 按逾期等级查询订单明细列表
     *
     * @param params 查询参数（包含overdueLevel等级参数）
     * @return 订单明细列表
     */
    List<CustomerCollectionAlertRecordVO> selectOverdueLevelDetailList(@Param("params") Map<String, Object> params);

    /**
     * 按逾期等级统计订单总数
     *
     * @param params 查询参数（包含overdueLevel等级参数）
     * @return 总数
     */
    Long countOverdueLevelDetail(@Param("params") Map<String, Object> params);

    /**
     * 按客户ID查询逾期统计（分析每个客户的账期情况）
     *
     * @param params 查询参数
     * @return 客户逾期统计列表
     */
    List<CustomerOverdueStatisticsVO> selectCustomerOverdueStatistics(@Param("params") Map<String, Object> params);

    /**
     * 按逾期等级查询客户统计（筛选有指定逾期等级订单的客户）
     *
     * @param params 查询参数（必须包含overdueLevel参数）
     * @return 客户逾期统计列表
     */
    List<CustomerOverdueStatisticsVO> selectCustomerStatisticsByLevel(@Param("params") Map<String, Object> params);
}
